Griffith 0.9.8 README
=====================

This document was last updated on Thu Sep 02 2007.
Please see the file COPYING for licensing and warranty information.
The latest version of this software is available at the following URL:
http://www.griffith.cc/


Table of Contents
=================

* Introduction
* System Requirements
* Installation
* Reporting Bugs
* TODO list
* About the Authors


Introduction
============

Griffith is a film collection manager, released under the GNU/GPL License.


System Requirements
===================

  Name			Minimum version		URL						NOTE
  ----			---------------		---						----
  * Python		2.3 or higher		http://www.python.org/
  * GTK+		tested on 2.6.4		http://www.gtk.org/
  * PyGTK (with glade2)	tested on 2.6.1		http://www.pygtk.org/
  * SQLAlchemy		0.3.10			http://www.sqlalchemy.org/			0.4 is not supported yet (0.3.11 is included in Griffith 0.9.8)
  * pysqlite2		2			http://initd.org/tracker/pysqlite		Python 2.5's sqlite3 module will be used if available
  * PIL						http://www.pythonware.com/products/pil/
  * PyXML					http://pyxml.sf.net/
  * ReportLab		1.19			http://www.reportlab.org

Other (optional) dependencies:
------------------------------

  PostgreSQL support:
  * Psycopg2		2			http://initd.org/tracker/psycopg/wiki/PsycopgTwo
  MySQL support:
  * MySQLDb					http://sourceforge.net/projects/mysql-python
  Upgrading from Griffith <=0.6.2 (only if pysqlite 1.0 was used before, 1.1 is not needed)
  * pysqlite		1.0 			http://initd.org/tracker/pysqlite
  Encoding detection of imported CSV file support:
  * chardet					http://chardet.feedparser.org/
  Gtkspell:
  * python-gnome-extras
  Covers and reports support:
  * PDF reader

To check dependencies:
----------------------
  $ ./griffith --check-dep

To show detected Python modules versions:
-----------------------------------------
  $ ./griffith --show-dep

Windows installer includes all the needed requirements.
A GTK+ runtime is not necessary when using this installer.


External databases
==================

You need to prepare a new database and a new user by yourself

PostgreSQL
----------

	CREATE USER griffith UNENCRYPTED PASSWORD 'gRiFiTh' NOCREATEDB NOCREATEUSER;
	CREATE DATABASE griffith WITH OWNER = griffith ENCODING = 'UNICODE';
	GRANT ALL ON DATABASE griffith TO griffith;

MySQL
-----

	CREATE DATABASE `griffith` DEFAULT CHARACTER SET utf8;
	CREATE USER 'griffith'@'localhost' IDENTIFIED BY 'gRiFiTh';
	CREATE USER 'griffith'@'%' IDENTIFIED BY 'gRiFiTh';
	GRANT ALL ON `griffith` . * TO 'griffith'@'localhost';
	GRANT ALL ON `griffith` . * TO 'griffith'@'%';

Microsoft SQL Server
--------------------
	CREATE DATABASE griffith
	EXEC sp_addlogin @loginame='griffith', @passwd='gRiFiTh', @defdb='griffith'
	GO
	USE griffith
	EXEC sp_changedbowner @loginame='griffith'


Installation
============

See INSTALL file


Reporting Bugs                                        
==============
	
If you want to help or report any bugs founded please visit:
  http://www.griffith.cc/
or
  https://bugs.launchpad.net/griffith/


TODO
====

See TODO file


About the Authors
=================

See AUTHORS file